package net.jgrm.order.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import net.jgrm.order.dto.CreateOrderRequest;
import net.jgrm.order.dto.OrderExportDTO;
import net.jgrm.order.dto.PaymentCallbackRequest;
import net.jgrm.order.dto.QueryOrderParams;
import net.jgrm.order.entity.Order;

import java.util.List;

/**
 * 订单服务接口
 */
public interface IOrderService extends IService<Order> {

    /**
     * 创建订单 - 使用Feign调用商品服务
     */
    Order createOrderWithFeign(Long userId, Long productId, Integer quantity);

    /**
     * 创建订单 - 使用Dubbo调用商品服务
     */
    Order createOrderWithDubbo(Long userId, Long productId, Integer quantity);

    /**
     * 创建订单 - 包含收货人信息和库存检查（使用Feign）
     *
     * @param request 创建订单请求
     * @return 订单信息
     */
    Order createOrderWithReceiverInfo(CreateOrderRequest request);

    /**
     * 支付成功回调处理
     *
     * @param request 支付回调请求
     * @return 处理结果
     */
    boolean handlePaymentCallback(PaymentCallbackRequest request);

    /**
     * 根据收货人姓名查询订单（支持加密存储的数据查询）
     *
     * @param receiverName 收货人姓名（明文）
     * @return 订单列表
     */
    List<Order> findOrdersByReceiverName(String receiverName);

    /**
     * 根据收货人手机号查询订单（支持加密存储的数据查询）
     *
     * @param receiverPhone 收货人手机号（明文）
     * @return 订单列表
     */
    List<Order> findOrdersByReceiverPhone(String receiverPhone);

    /**
     * 根据手机号前缀查询订单
     *
     * @param phonePrefix 手机号前3位
     * @return 订单列表
     */
    List<Order> findOrdersByReceiverPhonePrefix(String phonePrefix);

    /**
     * 根据手机号后缀查询订单
     *
     * @param phoneSuffix 手机号后4位
     * @return 订单列表
     */
    List<Order> findOrdersByReceiverPhoneSuffix(String phoneSuffix);

    /**
     * 根据查询参数进行统一查询
     * 支持手机号（完整、前缀、后缀）、姓名、订单状态等多种条件组合查询
     *
     * @param queryParams 查询参数
     * @return 订单列表
     */
    List<Order> findOrdersByQueryOrderParams(QueryOrderParams queryParams);

    /**
     * 根据查询参数进行分页查询
     * 支持手机号（完整、前缀、后缀）、姓名、订单状态等多种条件组合查询
     *
     * @param page        分页参数
     * @param queryParams 查询参数
     * @return 分页结果
     */
    Page<Order> findOrdersByQueryOrderParams(Page<Order> page, QueryOrderParams queryParams);
    
    /**
     * 导出订单数据到Excel
     * 
     * @param queryParams 查询参数
     * @return 订单导出数据列表
     */
    List<OrderExportDTO> exportOrders(QueryOrderParams queryParams);
}
